Rename clear_template to dispose_template
authorEmmanuele Bassi <ebassi@gnome.org>
Thu, 7 Jul 2022 13:09:35 +0000 (14:09 +0100)
committerEmmanuele Bassi <ebassi@gnome.org>
Mon, 11 Jul 2022 17:24:37 +0000 (18:24 +0100)
Make it more clear that the function is supposed to be called during the
dispose sequence of a widget.

28 files changed:
demos/constraint-editor/constraint-editor-window.c
demos/constraint-editor/constraint-editor.c
demos/constraint-editor/guide-editor.c
demos/gtk-demo/application.c
demos/gtk-demo/demo3widget.c
demos/gtk-demo/listbox.c
demos/icon-browser/iconbrowserwin.c
demos/node-editor/node-editor-window.c
gtk/gtkemojichooser.c
gtk/gtkfilechooserdialog.c
gtk/gtkfilechooserwidget.c
gtk/gtkfontchooserdialog.c
gtk/gtkmediacontrols.c
gtk/gtkstatusbar.c
gtk/gtkwidget.c
gtk/gtkwidget.h
gtk/inspector/a11y.c
gtk/inspector/actions.c
gtk/inspector/clipboard.c
gtk/inspector/general.c
gtk/inspector/list-data.c
gtk/inspector/logs.c
gtk/inspector/misc-info.c
gtk/inspector/recorder.c
gtk/inspector/resource-list.c
gtk/inspector/tree-data.c
gtk/inspector/visual.c
gtk/inspector/window.c

index 80dc10c1c381fc51cda4d99bd92a9f9c9b0ca3b1..fc4741318750bdb4ccb621e264ad65792c30fb46 100644 (file)
@@ -363,7 +363,7 @@ save_cb (GtkWidget              *button,
 static void
 constraint_editor_window_dispose (GObject *object)
 {
-  gtk_widget_clear_template (GTK_WIDGET (object), CONSTRAINT_EDITOR_WINDOW_TYPE);
+  gtk_widget_dispose_template (GTK_WIDGET (object), CONSTRAINT_EDITOR_WINDOW_TYPE);
 
   G_OBJECT_CLASS (constraint_editor_window_parent_class)->dispose (object);
 }
index 17407bb439781aab7b728c0fd59278efe50acb2d..3e77eca1d4a6c773c61d4514b073622c91272044 100644 (file)
@@ -610,7 +610,7 @@ constraint_editor_dispose (GObject *object)
   g_clear_object (&self->model);
   g_clear_object (&self->constraint);
 
-  gtk_widget_clear_template (GTK_WIDGET (object), CONSTRAINT_EDITOR_TYPE);
+  gtk_widget_dispose_template (GTK_WIDGET (object), CONSTRAINT_EDITOR_TYPE);
 
   G_OBJECT_CLASS (constraint_editor_parent_class)->dispose (object);
 }
index f7bc03937845feb4aaf09a20ef9b14c88fef449a..6e8e2ac5acc6a48ed7d69a02f4b92cfe219d2cc1 100644 (file)
@@ -296,7 +296,7 @@ guide_editor_dispose (GObject *object)
 
   g_clear_object (&self->guide);
 
-  gtk_widget_clear_template (GTK_WIDGET (self), GUIDE_EDITOR_TYPE);
+  gtk_widget_dispose_template (GTK_WIDGET (self), GUIDE_EDITOR_TYPE);
 
   G_OBJECT_CLASS (guide_editor_parent_class)->dispose (object);
 }
index e0acb60305b9928f37678e43426c24a746bfd451..a3e29bfb1c14999b1173250c0cb4009575d753bc 100644 (file)
@@ -504,7 +504,7 @@ demo_application_window_dispose (GObject *object)
 
   demo_application_window_store_state (window);
 
-  gtk_widget_clear_template (GTK_WIDGET (window), demo_application_window_get_type ());
+  gtk_widget_dispose_template (GTK_WIDGET (window), demo_application_window_get_type ());
 
   G_OBJECT_CLASS (demo_application_window_parent_class)->dispose (object);
 }
index 51a820a3ffa467a0e22a0953fd1c406cfa678be2..9f8d943d14f005437906803e462a6f8dcbf03a8b 100644 (file)
@@ -38,7 +38,7 @@ demo3_widget_dispose (GObject *object)
 
   g_clear_object (&self->paintable);
 
-  gtk_widget_clear_template (GTK_WIDGET (self), DEMO3_TYPE_WIDGET);
+  gtk_widget_dispose_template (GTK_WIDGET (self), DEMO3_TYPE_WIDGET);
 
   G_OBJECT_CLASS (demo3_widget_parent_class)->dispose (object);
 }
index c08cf681b726f87aa65ebfabf81e85088dfe52af..49bd2135ae0b42bf61e936df6a72715beef48ac7 100644 (file)
@@ -263,7 +263,7 @@ gtk_message_row_state_flags_changed (GtkWidget    *widget,
 static void
 gtk_message_row_dispose (GObject *obj)
 {
-  gtk_widget_clear_template (GTK_WIDGET (obj), GTK_TYPE_MESSAGE_ROW);
+  gtk_widget_dispose_template (GTK_WIDGET (obj), GTK_TYPE_MESSAGE_ROW);
   G_OBJECT_CLASS (gtk_message_row_parent_class)->dispose (obj);
 }
 
index 6a130c45a179db39b80dca4733fcef48a6ec1c0a..d0da5c464c5c320b0d8c17a47f5494e642a5cadd 100644 (file)
@@ -412,7 +412,7 @@ icon_browser_window_init (IconBrowserWindow *win)
 static void
 icon_browser_window_dispose (GObject *object)
 {
-  gtk_widget_clear_template (GTK_WIDGET (object), ICON_BROWSER_WINDOW_TYPE);
+  gtk_widget_dispose_template (GTK_WIDGET (object), ICON_BROWSER_WINDOW_TYPE);
 
   G_OBJECT_CLASS (icon_browser_window_parent_class)->dispose (object);
 }
index d9bc5eff0f86fd5881c03f77c8db154a1666437c..25cf11b48d74079c73cdfbc90c00b02c5ab806d2 100644 (file)
@@ -876,7 +876,7 @@ dark_mode_cb (GtkToggleButton *button,
 static void
 node_editor_window_dispose (GObject *object)
 {
-  gtk_widget_clear_template (GTK_WIDGET (object), NODE_EDITOR_WINDOW_TYPE);
+  gtk_widget_dispose_template (GTK_WIDGET (object), NODE_EDITOR_WINDOW_TYPE);
 
   G_OBJECT_CLASS (node_editor_window_parent_class)->dispose (object);
 }
index 281772a6da429f44f9f2872751090fb1ce3a007a..adeb485c6c66039fd7233d022eb193b79afaf550 100644 (file)
@@ -252,7 +252,7 @@ gtk_emoji_chooser_finalize (GObject *object)
 static void
 gtk_emoji_chooser_dispose (GObject *object)
 {
-  gtk_widget_clear_template (GTK_WIDGET (object), GTK_TYPE_EMOJI_CHOOSER);
+  gtk_widget_dispose_template (GTK_WIDGET (object), GTK_TYPE_EMOJI_CHOOSER);
 
   G_OBJECT_CLASS (gtk_emoji_chooser_parent_class)->dispose (object);
 }
index c874d0c31a79d79e4b7ff7d84cfdefed1399de48..56b070a65a187c3b31c31a1d3f389e69641e9931 100644 (file)
@@ -380,7 +380,7 @@ gtk_file_chooser_dialog_activate_response (GtkWidget  *widget,
 static void
 gtk_file_chooser_dialog_dispose (GObject *object)
 {
-  gtk_widget_clear_template (GTK_WIDGET (object), GTK_TYPE_FILE_CHOOSER_DIALOG);
+  gtk_widget_dispose_template (GTK_WIDGET (object), GTK_TYPE_FILE_CHOOSER_DIALOG);
 
   G_OBJECT_CLASS (gtk_file_chooser_dialog_parent_class)->dispose (object);
 }
index 2d39c38eda4c2a6857b9e56ba5fc3f954f37b43e..da11ae735bf9cbebad6b0a251fa4b1161c1d29a9 100644 (file)
@@ -3137,7 +3137,7 @@ gtk_file_chooser_widget_dispose (GObject *object)
 
   remove_settings_signal (impl);
 
-  gtk_widget_clear_template (GTK_WIDGET (impl), GTK_TYPE_FILE_CHOOSER_WIDGET);
+  gtk_widget_dispose_template (GTK_WIDGET (impl), GTK_TYPE_FILE_CHOOSER_WIDGET);
 
   G_OBJECT_CLASS (gtk_file_chooser_widget_parent_class)->dispose (object);
 }
index 6fefcce24ad22353ee99c6c915575db3ec656484..5aeddd20c48538560fa8cc322b46ca0a9f1bd795 100644 (file)
@@ -232,7 +232,7 @@ gtk_font_chooser_dialog_dispose (GObject *object)
   /* tweak_button is not a template child */
   g_clear_pointer (&dialog->tweak_button, gtk_widget_unparent);
 
-  gtk_widget_clear_template (GTK_WIDGET (dialog), GTK_TYPE_FONT_CHOOSER_DIALOG);
+  gtk_widget_dispose_template (GTK_WIDGET (dialog), GTK_TYPE_FONT_CHOOSER_DIALOG);
 
   G_OBJECT_CLASS (gtk_font_chooser_dialog_parent_class)->dispose (object);
 }
index e7f279510dc4315ddd6d156bbb367107f6c94097..4dc8888e15f9233e49513416dec82fd8bccffd4f 100644 (file)
@@ -208,7 +208,7 @@ gtk_media_controls_dispose (GObject *object)
 
   gtk_media_controls_set_media_stream (controls, NULL);
 
-  gtk_widget_clear_template (GTK_WIDGET (object), GTK_TYPE_MEDIA_CONTROLS);
+  gtk_widget_dispose_template (GTK_WIDGET (object), GTK_TYPE_MEDIA_CONTROLS);
 
   G_OBJECT_CLASS (gtk_media_controls_parent_class)->dispose (object);
 }
index 98dc4c5c5bacaef7f2ae5a9630e680b4deaed81b..70afc1bdf4e72048f2b0db06fba2809d88368e12 100644 (file)
@@ -143,7 +143,7 @@ gtk_statusbar_dispose (GObject *object)
   g_slist_free_full (self->keys, g_free);
   self->keys = NULL;
 
-  gtk_widget_clear_template (GTK_WIDGET (self), GTK_TYPE_STATUSBAR);
+  gtk_widget_dispose_template (GTK_WIDGET (self), GTK_TYPE_STATUSBAR);
 
   G_OBJECT_CLASS (gtk_statusbar_parent_class)->dispose (object);
 }
index 2a3fa3042ebcbe8670d9f86dda2ccdee7f693abc..360d8412a8cbc3691f96b1affcf5e708565909f7 100644 (file)
  * }
  * ```
  *
- * as well as calling [method@Gtk.Widget.clear_template] from the dispose
+ * as well as calling [method@Gtk.Widget.dispose_template] from the dispose
  * function:
  *
  * ```c
  *   // Dispose objects for which you have a reference...
  *
  *   // Clear the template children for this widget type
- *   gtk_widget_clear_template (GTK_WIDGET (self), FOO_TYPE_WIDGET);
+ *   gtk_widget_dispose_template (GTK_WIDGET (self), FOO_TYPE_WIDGET);
  *
  *   G_OBJECT_CLASS (foo_widget_parent_class)->dispose (gobject);
  * }
  * static void
  * foo_widget_dispose (GObject *gobject)
  * {
- *   gtk_widget_clear_template (GTK_WIDGET (gobject), FOO_TYPE_WIDGET);
+ *   gtk_widget_dispose_template (GTK_WIDGET (gobject), FOO_TYPE_WIDGET);
  *
  *   G_OBJECT_CLASS (foo_widget_parent_class)->dispose (gobject);
  * }
@@ -10998,7 +10998,7 @@ out:
 }
 
 /**
- * gtk_widget_clear_template:
+ * gtk_widget_dispose_template:
  * @widget: the widget with a template
  * @widget_type: the type of the widget to finalize the template for
  *
@@ -11022,7 +11022,7 @@ out:
  *   SomeWidget *self = SOME_WIDGET (gobject);
  *
  *   // Clear the template data for SomeWidget
- *   gtk_widget_clear_template (GTK_WIDGET (self), SOME_TYPE_WIDGET);
+ *   gtk_widget_dispose_template (GTK_WIDGET (self), SOME_TYPE_WIDGET);
  *
  *   G_OBJECT_CLASS (some_widget_parent_class)->dispose (gobject);
  * }
@@ -11031,8 +11031,8 @@ out:
  * Since: 4.8
  */
 void
-gtk_widget_clear_template (GtkWidget *widget,
-                           GType      widget_type)
+gtk_widget_dispose_template (GtkWidget *widget,
+                             GType      widget_type)
 {
   g_return_if_fail (GTK_IS_WIDGET (widget));
   g_return_if_fail (g_type_name (widget_type) != NULL);
index fede1b634e0938fa3874e992183d65266fb57401..8720017baddbebbbe981b0116557a173aad6e65a 100644 (file)
@@ -834,7 +834,7 @@ GObject *gtk_widget_get_template_child                  (GtkWidget             *
                                                          GType                  widget_type,
                                                          const char            *name);
 GDK_AVAILABLE_IN_4_8
-void    gtk_widget_clear_template                       (GtkWidget             *widget,
+void    gtk_widget_dispose_template                     (GtkWidget             *widget,
                                                          GType                  widget_type);
 GDK_AVAILABLE_IN_ALL
 void    gtk_widget_class_set_template                   (GtkWidgetClass        *widget_class,
index 178b5d138af12cd0f001ecf97cd982c4c34c1b24..9a9140e183cf69dacf6260d4b758f91c594fae6e 100644 (file)
@@ -462,7 +462,7 @@ dispose (GObject *o)
 
   g_clear_object (&sl->object);
 
-  gtk_widget_clear_template (GTK_WIDGET (o), GTK_TYPE_INSPECTOR_A11Y);
+  gtk_widget_dispose_template (GTK_WIDGET (o), GTK_TYPE_INSPECTOR_A11Y);
 
   G_OBJECT_CLASS (gtk_inspector_a11y_parent_class)->dispose (o);
 }
index be621b28f9e65df943735a7e44177589598c6699..24afc478567c018171a31ef17d9e89342e0482cd 100644 (file)
@@ -425,7 +425,7 @@ dispose (GObject *object)
   g_clear_object (&sl->actions);
   g_clear_object (&sl->object);
 
-  gtk_widget_clear_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_ACTIONS);
+  gtk_widget_dispose_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_ACTIONS);
 
   G_OBJECT_CLASS (gtk_inspector_actions_parent_class)->dispose (object);
 }
index dd85dcb736e1596ab3ad0957ecdcea346813b3c0..edfb8b6ca47790984cd25ff624b652c6ea991ed6 100644 (file)
@@ -355,7 +355,7 @@ gtk_inspector_clipboard_dispose (GObject *object)
 
   gtk_inspector_clipboard_unset_display (self);
 
-  gtk_widget_clear_template (GTK_WIDGET (self), GTK_TYPE_INSPECTOR_CLIPBOARD);
+  gtk_widget_dispose_template (GTK_WIDGET (self), GTK_TYPE_INSPECTOR_CLIPBOARD);
 
   G_OBJECT_CLASS (gtk_inspector_clipboard_parent_class)->dispose (object);
 }
index 485a98cea12a8a8c035bb7186981bd9fe9d63597..951ce98d1e0220c6aaa8d92f96137a0cc00e571b 100644 (file)
@@ -1097,7 +1097,7 @@ gtk_inspector_general_dispose (GObject *object)
     disconnect_seat (gen, GDK_SEAT (l->data));
   g_list_free (list);
 
-  gtk_widget_clear_template (GTK_WIDGET (gen), GTK_TYPE_INSPECTOR_GENERAL);
+  gtk_widget_dispose_template (GTK_WIDGET (gen), GTK_TYPE_INSPECTOR_GENERAL);
 
   G_OBJECT_CLASS (gtk_inspector_general_parent_class)->dispose (object);
 }
index 3978bf17847e589c286202071b517e58842a3542..c56defef951da858cff8d1a5a36c9d0d34be4350 100644 (file)
@@ -191,7 +191,7 @@ dispose (GObject *object)
 {
   GtkInspectorListData *sl = GTK_INSPECTOR_LIST_DATA (object);
 
-  gtk_widget_clear_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_LIST_DATA);
+  gtk_widget_dispose_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_LIST_DATA);
 
   G_OBJECT_CLASS (gtk_inspector_list_data_parent_class)->dispose (object);
 }
index ac9b88b0760464d95c93a49053b407a2760aaa14..97b5cf17c29e1347523d03b7afbb39a9b8c35278 100644 (file)
@@ -99,7 +99,7 @@ gtk_inspector_logs_init (GtkInspectorLogs *logs)
 static void
 dispose (GObject *object)
 {
-  gtk_widget_clear_template (GTK_WIDGET (object), GTK_TYPE_INSPECTOR_LOGS);
+  gtk_widget_dispose_template (GTK_WIDGET (object), GTK_TYPE_INSPECTOR_LOGS);
 
   G_OBJECT_CLASS (gtk_inspector_logs_parent_class)->dispose (object);
 }
index ba9358147a538a56cc59151578fee1799af55e88..ff028d13d43525dffc3a657f732a03e1f1865668 100644 (file)
@@ -603,7 +603,7 @@ dispose (GObject *o)
 {
   GtkInspectorMiscInfo *sl = GTK_INSPECTOR_MISC_INFO (o);
 
-  gtk_widget_clear_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_MISC_INFO);
+  gtk_widget_dispose_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_MISC_INFO);
 
   G_OBJECT_CLASS (gtk_inspector_misc_info_parent_class)->dispose (o);
 }
index 9e4ed37ca06ab1c992d0d765cd6297abff90eff3..e5caf293fa6f04555249601604f3e4b301f03fb2 100644 (file)
@@ -2043,7 +2043,7 @@ gtk_inspector_recorder_dispose (GObject *object)
   g_clear_object (&recorder->render_node_root_model);
   g_clear_object (&recorder->render_node_selection);
 
-  gtk_widget_clear_template (GTK_WIDGET (recorder), GTK_TYPE_INSPECTOR_RECORDER);
+  gtk_widget_dispose_template (GTK_WIDGET (recorder), GTK_TYPE_INSPECTOR_RECORDER);
 
   G_OBJECT_CLASS (gtk_inspector_recorder_parent_class)->dispose (object);
 }
index 86112ac48780eb375a4335660f55e7940ebae887..3c0dc2a38eea2cd3e9943abfae95f065ebfa1d72 100644 (file)
@@ -768,7 +768,7 @@ dispose (GObject *object)
   g_clear_object (&rl->selection);
   g_clear_object (&rl->tree_model);
 
-  gtk_widget_clear_template (GTK_WIDGET (rl), GTK_TYPE_INSPECTOR_RESOURCE_LIST);
+  gtk_widget_dispose_template (GTK_WIDGET (rl), GTK_TYPE_INSPECTOR_RESOURCE_LIST);
 
   G_OBJECT_CLASS (gtk_inspector_resource_list_parent_class)->dispose (object);
 }
index a4fd0b72e42c282ba1765bbf5aad4058ad3c91d6..b0e23c293323c34c08fc2f2ff4f7a65bbcd90258 100644 (file)
@@ -176,7 +176,7 @@ dispose (GObject *object)
 {
   GtkInspectorTreeData *sl = GTK_INSPECTOR_TREE_DATA (object);
 
-  gtk_widget_clear_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_TREE_DATA);
+  gtk_widget_dispose_template (GTK_WIDGET (sl), GTK_TYPE_INSPECTOR_TREE_DATA);
 
   G_OBJECT_CLASS (gtk_inspector_tree_data_parent_class)->dispose (object);
 }
index 4b4d44c62ee5d9c0316e63855628bcd8f850f200..19ac88b4ef118ba64392ff7c42eb4f84ab1d012a 100644 (file)
@@ -1134,7 +1134,7 @@ gtk_inspector_visual_dispose (GObject *object)
 {
   GtkInspectorVisual *vis = GTK_INSPECTOR_VISUAL (object);
 
-  gtk_widget_clear_template (GTK_WIDGET (vis), GTK_TYPE_INSPECTOR_VISUAL);
+  gtk_widget_dispose_template (GTK_WIDGET (vis), GTK_TYPE_INSPECTOR_VISUAL);
 
   G_OBJECT_CLASS (gtk_inspector_visual_parent_class)->dispose (object);
 }
index 8a0d198fa1bd924d69c18f3d595b5f2fec81a795..2bc45d82674b190ef186f15bd7bd21b81a1462d4 100644 (file)
@@ -314,7 +314,7 @@ gtk_inspector_window_dispose (GObject *object)
   g_clear_object (&iw->flash_overlay);
   g_clear_pointer (&iw->objects, g_array_unref);
 
-  gtk_widget_clear_template (GTK_WIDGET (iw), GTK_TYPE_INSPECTOR_WINDOW);
+  gtk_widget_dispose_template (GTK_WIDGET (iw), GTK_TYPE_INSPECTOR_WINDOW);
 
   G_OBJECT_CLASS (gtk_inspector_window_parent_class)->dispose (object);
 }